Function Reference

_IEPropertyGet

Returns a select property of the Browser.

#include <IE.au3>
_IEPropertyGet ( ByRef $o_object, $s_property )

 

Parameters

$o_object Object variable of an InternetExplorer.Application
$s_property Property selection (see remarks)

 

Return Value

Success: Value of selected Property
Failure: Returns 0 and sets @ERROR
@Error: 0 ($_IEStatus_Success) = No Error
3 ($_IEStatus_InvalidDataType) = Invalid Data Type
4 ($_IEStatus_InvalidObjectType) = Invalid Object Type
5 ($_IEStatus_InvalidValue) = Invalid Value
@Extended: Contains invalid parameter number

 

Remarks

Further information can be found at MSDN.

The following tables provide a description of each property available for use.

Browser Properties

Property Description
"addressbar" Retrieves whether the address bar of the object is visible or hidden.
"busy" Retrieves a Boolean value indicating whether the object is engaged in a navigation or downloading operation.
"fullscreen" Retrieves a Boolean value that indicates whether Microsoft Internet Explorer is in full-screen or normal window mode.
"height" Retrieves the height of the Internet Explorer main window.
"hwnd" Retrieves the handle of the Internet Explorer main window.
"isdisabled" Retrieves the value indicating whether the user can interact with the object.
"left" Retrieves the screen coordinate of the left edge of the main window of the object.
"locationname" Retrieves the name of the resource that Internet Explorer is currently displaying.
"locationurl" Retrieves the URL of the resource that Internet Explorer is currently displaying.
"menubar" Retrieves a Boolean value that indicates whether the Internet Explorer menu bar is visible.
"offline" Retrieves a Boolean value that indicates whether the object is currently operating in offline mode.
"readystate" Retrieves the ready state of the object.
"resizable" Retrieves a value that indicates whether the object can be resized.
"silent" Retrieves a value that indicates whether the object can show dialog boxes.
"statusbar" Retrieves a value that indicates whether the status bar for the object is visible.
"statustext" Retrieves the text in the status bar for the object.
"top" Retrieves the screen coordinate of the top edge of the main window of the object.
"visible" Retrieves a value that indicates whether the object is visible or hidden.
"width" Retrieves the width of the main window for the object.

ClientInfo Properties

Property Description
"appcodename" Retrieves the code name of the browser (the property has a default value of Mozilla).
"appminorversion" Retrieves the application's minor version value.
"appname" Retrieves the name of the browser (the property has a default value of Microsoft Internet Explorer).
"appversion" Retrieves the platform and version of the browser.
"browserlanguage" Retrieves the current browser language (the value will be one of these Language Codes).
"cookieenabled" Retrieves whether client-side persistent cookies are enabled in the browser. Persistent cookies are those that are stored on the client-side computer.
"cpuclass" Retrieves a string denoting the CPU class (the return values can be found here).
"javaenabled" Returns whether Java is enabled.
"online" Retrieves a value indicating whether the system is in global offline mode.
"platform" Retrieves the name of the user's operating system (the return values can be found here).
"systemlanguage" Retrieves the default language used by the operating system (the value will be one of these Language Codes).
"useragent" Retrieves a string equivalent to the HTTP user-agent request header.
"userlanguage" Retrieves the operating system's natural language setting (the value will be one of these Language Codes).
"vcard" Returns an array containing each attribute in the userProfile object (a list of attributes can be found here). The return is a two dimentional array, where the first dimention has two elements. The first element (0) contains the attribute names, the second element (1) contains the corresponding values. The second dimention has 29 elements (0 to 28).

 

Related

_IEPropertySet

 

Example


; *******************************************************
; Example 1 - Open a browser with the basic example, check to see if the
;               addressbar is visible, if it is turn it off, if it is not turn it on
; *******************************************************
;
#include <IE.au3>
$oIE = _IE_Example ("basic")
If _IEPropertyGet ($oIE, "addressbar") Then
    MsgBox(0, "AddressBar Status", "AddressBar Visible, turning it off")
    _IEPropertySet ($oIE, "addressbar", False)
Else
    MsgBox(0, "AddressBar Status", "AddressBar Invisible, turning it on")
    _IEPropertySet ($oIE, "addressbar", True)
EndIf